Installing CFX2 on Windows

- Install Java SDK
  - Go to url http://java.sun.com/j2se/downloads.html
  - Download and install the full version

- Install MySql (standard) 4.0
  - Go to http://www.mysql.com/downloads/ or to 
    http://mirror.sit.wisc.edu/mysql/downloads/mysql-4.0.html
  - download and install the setup file
  - read the mysql manual to set up mysql server. 
    - Sections 2.1, 2.4, and http://www.mysql.com/doc/en/NT_start.html 
      are useful to setup mysql for the first time. 
    - Sections 4.3.4, 4.3.5 tells how to add users to mysql.
  - Start the mysql server from the  Win2k Services

- Install MySql Front GUI 
  - the setup is included with the installation
  - open the GUI
  - connect to the mysql database using the root/user password
  - create a blank database, and name it CFX2
  - open a query window
  - open file CFX2<Date>.sql in the query window 
    (e.g.CFX2May26.sql). This is the CFX file containing sample data 
    that we currently have. Execute the query to populate the database.
  - for GUI-less Unix, refer to the mysql manual on how to import 
    the contents of a .sql file into the database

- Install Tomcat4
  - go to http://jakarta.apache.org/site/binindex.cgi
    or to http://ftp.epix.net/apache/jakarta/tomcat-4/binaries/
  - download and install the full edition 
  - setup these environment variables 
     CATALINA_BASE=C:\Tomcat 4.1
     CATALINA_HOME=C:\Tomcat 4.1
     CATALINA_TMP=C:\Tomcat 4.1\temp
     CLASSPATH=C:\Tomcat 4.1\common\lib\servlet.jar;C:\Tomcat 4.1\webapps\CFX2\WEB-INF\classes
  - start tomcat from the Control Panel to test it. Tomcat should have 
    installed as a WinNT service
  - browse to http://localhost:8080 in your browser
  - if the tomcat page doesn't load, something was done incorrectly!

  - open server.xml from the tomcat4 directory. Make changes to it based on the sample
    server.xml file that is bundled with the installation. Add a <Context> element 
    after the Context element for "examples". It goes like this:
     <Context path="/CFX2" docBase="CFX2" ...>
  - copy the local CFX2 directory into C:/Tomcat4.1/webapps/
  - edit C:/Tomcat4.1/webapps/CFX2/WEB-INF/web.xml - change MySql username and password 
    so CFX2 can access the database
  - restart tomcat4
  - browse to http://localhost:8080/CFX2/MainUI.jsp   <from windows>
        or to http://localhost:8080/CFX2/NSMainUI.htm <from linux>

- Troubleshooting
  - if http://<yourhost>:<yourport>/CFX2/servlet/HelloWorld doesn't work,
    check internet connection, dhcp setup